import { i18n } from '/@/locales/setupI18n';

/**
 * I18nGlobalTranslation 是一个函数类型,由于这个类型定义中小括号有多个，表示这个函数类型可以接受多个不同的参数组合。
 * 具体来说，这个函数类型定义了六个不同的函数签名，每个函数签名具有不同的参数组合和返回类型。这样的定义允许开发者根据具体的使用情况选择不同的参数形式来调用这个函数类型。
 */
type I18nGlobalTranslation = {
  (key: string): string;
  (key: string, locale: string): string;
  (key: string, locale: string, list: unknown[]): string;
  (key: string, locale: string, named: Record<string, unknown>): string;
  (key: string, list: unknown[]): string;
  (key: string, named: Record<string, unknown>): string;
};
//元组类型
type I18nTranslationRestParameters = [string, any];

/**
 * 根据命名空间和键名返回完整的 I18n 键名。
 *
 * @param {string|undefined} namespace 命名空间，如果为 `undefined`，则返回仅包含键名的 I18n 键名。
 * @param {string} key I18n 键名。
 * @returns {string} 完整的 I18n 键名。
 */
function getKey(namespace: string | undefined, key: string) {
  if (!namespace) {
    return key;
  }
  if (key.startsWith(namespace)) {
    return key;
  }
  return `${namespace}.${key}`;
}

/**
 * 返回一个 I18n 翻译助手对象，用于在 Vue 组件中调用翻译函数。
 *
 * @param {string|undefined} namespace 当前命名空间，如果不需要命名空间，则为 `undefined`。
 * @returns {{ t: I18nGlobalTranslation }} I18n 翻译助手对象，包括全局翻译函数 `t`。
 */
export function useI18n(namespace?: string): {
  t: I18nGlobalTranslation;
} {
  //用于创建一个普通的翻译助手对象 normalFn，其中包含一个名为 t 的方法，该方法接受一个字符串类型的参数 key，并返回一个经 getKey() 函数处理后的 I18n 键名字符串。
  const normalFn = {
    t: (key: string) => {
      return getKey(namespace, key);
    },
  };

  if (!i18n) {
    return normalFn;
  }

  const { t, ...methods } = i18n.global;

  const tFn: I18nGlobalTranslation = (key: string, ...arg: any[]) => {
    if (!key) return '';
    if (!key.includes('.') && !namespace) return key;
    return t(getKey(namespace, key), ...(arg as I18nTranslationRestParameters));
  };
  return {
    ...methods,
    t: tFn,
  };
}

// Why write this function？
// Mainly to configure the vscode i18nn ally plugin. This function is only used for routing and menus. Please use useI18n for other places

// 为什么要编写此函数？
// 主要用于配合vscode i18nn ally插件。此功能仅用于路由和菜单。请在其他地方使用useI18n
export const t = (key: string) => key;
